home *** CD-ROM | disk | FTP | other *** search
/ Gekikoh Dennoh Club 1 / Gekikoh Dennoh Club Vol. 1 (Japan).7z / Gekikoh Dennoh Club Vol. 1 (Japan) (Track 1).bin / kowin / archive / sys / kowin14d.lzh / doc / programming / kowin_p10.doc < prev    next >
Text File  |  1995-12-02  |  9KB  |  225 lines
  1.  
  2.  Ko-Window アプリケーションの作成スタイル
  3.  
  4.  
  5.   Ko-Window のアプリケーションを作る時に、ある程度標準化すべき点についてまと
  6. めます。
  7.  
  8.  
  9.  
  10. ●オプションスイッチの統一
  11.  
  12.   -x, -y, -h, -v オプションはウィンドウの位置や大きさを決める重要なオプショ
  13. ンで、各種ウィンドウマネージャーや KF がこれらオプションを指定してプログラム
  14. を起動することがあります。ですから、可能な限りサポートし、もしくは意味を変更
  15. しないで使用するようにして下さい。
  16.  
  17.   -x, -y, -h, -v オプションの解析は、AnalyzeArgs() (winop.a) を使います。
  18.  
  19. <例>    argc= AnalyzeArgs( argc, argv, &x, &y, &h, &v );
  20.  
  21.  -h, -v オプションが不要な場合は、&h, &v の部分に NULL を与えて下さい。
  22.  
  23.   その他のオプションに対しては特に決まりはありませんので、アプリケーション側
  24. で判断して使用するようにして下さい。ただし慣例的に、-a は表示アトリビュート
  25. の指定、-f は表示フォントサイズの指定に使われます。強制ではありませんが、筆
  26. 者はだいたい次のような使い分けをしているので参考にして下さい。
  27.  
  28.     -a<n>        表示アトリビュート
  29.     -f<n>        フォントサイズ
  30.     -c<n>        表示の横桁幅指定 (Command.win, tview など)
  31.     -F<n>        1行分のドット数 (tview, view など)
  32.     -l<n>        ウィンドウなどの行数の指定 (MiniTERM, ro, k20 など)
  33.  
  34.  
  35.  
  36. ●マウスボタンの使い方は？
  37.  
  38.   特に決まりはありませんが、ウィンドウ背景やタイトルバー上では、マウスの右ボ
  39. タンはウィンドウマネージャーのポップアップメニューを表示するために使われるの
  40. で、それにならうのが普通です。またライブラリルーチンもだいたい左ボタンがクリッ
  41. クによるアクションや Clip 時の範囲指定、右ボタンがメニューに使うよう作られて
  42. います。
  43.  
  44.   筆者は、新しいものを考案していく上では足かせがないのがフリーソフトウエアな
  45. らではの利点だと考えています。だから、使いやすさ、便利さを追及した上でなら、
  46. 可能性がある限りどんな操作方法でも可でしょう。
  47.  
  48.   ただし、プログラム上の手抜き、または特に理由もポリシーも無しに他のシステム
  49. の単なる真似、によってこれまでの Ko-Window アプリケーションらと大きく異なり
  50. 混乱を招きかねない操作方法を採用するのは、好ましくありません。
  51.  
  52.  
  53.  
  54. ●ウィンドウ間インターフェース
  55.  
  56.   Ko-Window のアプリケーションプログラミングにおける、最重要視すべき点です。
  57.  EventUser の各種データ送受信に対しては、可能な限り対応するよう必ず努力して
  58. 下さい。
  59.  
  60.   簡単にいえば、例えば起動後にファイル名を得る必要があるアプリケーションでは
  61.  kf からファイルを受け取れるようにして下さい、ということです。また同様に、内
  62. 部で持っているファイル名等の所有している情報は、外に発信できるようにして下さ
  63. い。
  64.  
  65.   これはどうせ有用じゃないから、という心配は無用。とにかく転送できるようにし
  66. ておけば、応用がききます。例えば sreport.win や timer.win の時計でも、時刻と
  67. いう文字列を他のウィンドウへ転送できるわけです。もちろんアプリケーションによっ
  68. ては Clip Board を使うのもいいでしょう。
  69.  
  70.   文字列に限らず、bitmap なら Sheet (UserSheet)、グラフィック画像なら UGraphic
  71. (UserGraphic)、PCM に関しては PowerWave(作:CAB氏) のドキュメントにフォーマッ
  72. トの規定があります。
  73.  
  74.   以下いくつかの具体例です。
  75.  
  76. ・外部データの受取
  77.  
  78. (1) ファイル名を得たい場合
  79.  
  80. <例> 受け取ったファイル名からすぐアクションを起こす場合(画像ローダーなど)
  81. -----------------------------------------------------------------------------
  82.     case EventUser:
  83.         switch( info->ComData ){
  84.         case UserPaste:
  85.         case UserString:
  86.             file_read( info->ComBuffer );
  87.             return    TRUE;
  88.         case UserStrings:
  89.             {
  90.                 char    *pptr= info->ComBuffer;
  91.                 for(; *pptr ;)
  92.                     file_read( *pptr++ );
  93.             }
  94.         /*受け取れるファイル名が1つのみならループする必要はない
  95.             file_read( *(char**)info->ComBuffer ); など */
  96.             return    TRUE;
  97.         }
  98.         return    FALSE;
  99. -----------------------------------------------------------------------------
  100.   もしファイル名をキー入力するための部分があるなら、UserString/UserPaste は
  101. 上記のようにそのままファイル名とせず、キー入力文字列として自分自身に転送する
  102. ようにするといいでしょう。corlib.a にある ClipGetKeyBoard() などの関数が便利
  103. です。その場合でも UserStrings で受け取ったファイル名は、そのままアクション
  104. を起こして構いません。
  105.  
  106. <例> UserPaste/String はキー入力として渡すが Strings(KFからの転送)の場合はそ
  107.      のままアクションを起こす
  108. -----------------------------------------------------------------------------
  109.     case EventUser:
  110.         switch( info->ComData ){
  111.         case UserPaste:
  112.         case UserString:
  113.             return    ClipGetKeyBoardAll( wp, info );
  114.         case UserStrings:
  115.             {
  116.                 char    *pptr= info->ComBuffer;
  117.                 for(; *pptr ;)
  118.                     file_read( *pptr++ );
  119.             }
  120.             return    TRUE;
  121.         }
  122.         return    FALSE;
  123. -----------------------------------------------------------------------------
  124.  
  125.  
  126. (2) Sheet データを得る場合 (Ko-Window の bitmap)
  127.  
  128.   Sheet データのリアルタイム受け取りは、パターンデータを扱うアプリケーション
  129. では重要です。ですが、それ以外にも例えばゲームでゲーム中のキャラクタをいきな
  130. り UserEvent で受け取ってそのまま使用してしまう、なんてことができるでしょう。
  131. (例えば shotZ の自機デザインなどはこれに対応しています)
  132.  
  133. <例> UserSheet の受取、 UserString/Strings のファイル名は、Sheetファイルと見
  134.      なしデータとしてロードできるようにすることもある。
  135. -----------------------------------------------------------------------------
  136.     case EventUser:
  137.         switch( info->ComData ){
  138.         case UserSheet:
  139.             copy_sheet( info->ComBuffer );
  140.             return    TRUE;
  141.         }
  142.         return    FALSE;
  143. -----------------------------------------------------------------------------
  144. 受け取ったデータは、必ず自分のアプリケーション上にコピーしなければなりません。
  145.  
  146.  
  147. (3) 画像を受け取る場合
  148.  
  149.   画像データは UserGraphic としてフォーマットが定義されました。UserGraphic.doc
  150. を参照して下さい。受け取り方は Sheet の場合とほとんど同じです。また関連ライ
  151. ブラリとして gvlib.a も用意しました。こちらも合せて参照して下さい。
  152.  
  153.  
  154.  
  155. (4)そのほか
  156.  
  157.   受け取れるのはデータだけではありません。コマンドを受け取ることができるアプ
  158. リケーションはかなり多く存在します。例えば Command.win は外部からイベントに
  159. よってプログラムを走らせることができたり、KF は内部コマンドを全部外部のイベ
  160. ントで実行できたり、プレイヤーは音楽操作を外部のイベント送信でコントロールで
  161. きたり、します。そのコマンド送受信の方法は大きく分けて２種類存在します。
  162.  
  163.     ・UserString を使う場合
  164.         UserString で送られてきた文字列がコマンド名ならそれを解釈し
  165.         て実行します。例えばプレイヤーでは、"Play:" という文字列が送
  166.         られてきたら再生を開始する、といった感じです。ファイル名も受
  167.         け取れるようにしているアプリケーションの場合は、ファイル名と
  168.         区別できる形になっていなければなりません。(た問えば "Play:"
  169.         のように、最後にコロンをつけるなど)
  170.         この方法は、送信側に特に工夫が要らず簡単で、応用がききやすい
  171.         ためかなりよく使われます。ただし、エディタなどキー入力を必要
  172.         とするアプリケーションでは、UserString をそのまま文字列のデー
  173.         タとして受け取りたいので、この方法をコマンド判定に使うのはあ
  174.         まりよくありません。
  175.  
  176.     ・アプリケーション専用の User インターフェースを設ける場合
  177.         例えば info->UserData が 'COM' なら、info->ComBuffer を文字
  178.         列としてその内容をコマンドとして判定して実行する、というもの
  179.         です。Command.win など UserString はそのままデータとして判断
  180.         した方が良いものではこの方法を使っています。UserData の決め
  181.         方は user.doc を参照して下さい。また送信するデータは、
  182.         UserString 同様に info->ComBuffer は単純な文字列のポインタと
  183.         して、コマンド判断を行うようにして下さい。例えば数値を送る場
  184.         合も "set:123" などのように数値の文字列として送受信します。
  185.         文字列であれば、usend や wsh からイベントを送信する処理が簡
  186.         単に書けてたいへん都合がいいからです。
  187.  
  188.  
  189. ・外部へのデータの送信
  190.  
  191.   内部でもっている文字列などは、可能な限り送信できるように作っておくといいで
  192. しょう。単一行の文字列の場合、例えばファイル名の場合は、ポインタを与えて
  193.  UserSendOperation() を使いダイレクト転送するだけです。これだと極めて簡単で、
  194. またアプリケーションの負担になりません。
  195.  
  196. <例>
  197. -----------------------------------------------------------------------------
  198.     case EventMouseSwitch:
  199.         if( info->LeftON ){
  200.             UserSendOperation( wp, info, UserString, FileName );
  201.             return    TRUE;
  202.         }
  203.         return    FALSE;
  204. -----------------------------------------------------------------------------
  205.  UserSendOperation() は文字列だけでなく、Sheet や UGraphic といった画像や、
  206.  PCM データでもそのまま使用することができます。
  207.  
  208.   まとめたテキストや、または任意部分を切り出して送るような場合は Clip Board
  209. 経由で clip & paste を使います。これは ClipSetOperation() を使うと便利です。
  210. ClipSetOperation() は tvlib のソースでも使われています。ぜひ参考にして下さい。
  211.  
  212.  
  213.   この辺は Ko-Window アプリケーションの連係、自由度をあげる部分でもあるので、
  214. ぜひこだわって作り、素晴らしいアプリケーションに仕上げて下さい。
  215.  
  216.  
  217.  
  218. ----
  219. 1995 11/27 初期公開版
  220.  
  221. 小笠原博之
  222. oga@dgw.yz.yamagata-u.ac.jp
  223. DenDenNET: DEN0006 COR.
  224.  
  225.